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1.0 OVERVIEW 



UNIX 2.0 contains several new features, including drivers for SMD controllers, 
|nd Cipher and DEI tape drives* There is a boot/ system load program to allow 
Isers to load a System 200 from tape, bad block handling, new utilities and 
several bug fixes-* 

A more detailed description of these improvements, instructions for loading from 
tape and diskette, and Information on configuring and using the system is given 
in this release notice* 

1.1 MEMORY REQUIREMENTS 

The memory requirements of the UNIX operating system and some often-used 
utilities are given below, /unix must always remain in core, but the 
other utilities may be swapped out to disk when there is not enough room 
in main memory. 



process 1st user each additional user 



/ unix 


180Kb 


0Kb 


/bin/csh(C-shell) 


84Kb 


32Kb 


/bin/sh(Bourne shell) 


48Kb 


24Kb 


/usr/bin/ vl 


148Kb 


36Kb 


/usr/bln/ex 


148Kb 


36Kb 


/usr/bin/nroff 


78Kb 


23Kb 


/ lib/ ccom( largest part 






of C compiler) 


156Kb 


76Kb 


/lib/f77passl(largest part 






of fortram compiler) 


115Kb 


50Kb 



The stack size for these utilities may vary, which may cause compiling 
or editing large files to increase the process size somewhat. The UNIX 
operating system will automatically have other processes, including 
/etc/ update, /etc/cron, and /etc/init executing at most times. These 
processes will be swapped out to disk when too much main memory is 
consumed, so they will not significantly add to memory requirements. 



2. RELEASE DESCRIPTION 

The directory structure for the UNIX operating system is as follows: 



/ (root) 
I 



till t I I I 

bin dev etc lib lost+found usr flop fsys 

I 



till II I II I I I I 

a dm bin | include duplicate I lost+found backup lib I |dict games 

guest | spool I tmp I I 

I I I I ! I I I I I I I I 

SIII misc sys local I help lint lex tmac term I I lib 

I I I 



, 

I I I I I III I 

at lpd mail uucp uucppublic me uucp tabset I 

I I I 
src src 

I I 
past — — 

I 

unix 
I 

II 
lib sys 



Note; Some of these directories are used for floppy diskette backup 
and may not be on the system 200. 



The files included in this release are as follows: 



/ (root) 



•cshrc 


•login 


bin 




etc 


fsys 


lost+found unix 


«exrc 


•profile 


dev 




flop 


lit, 

lib 


tmp 


usr 




•/ Din. 


















[ 


cc csh 


du 


grep 


Is 


nice ps 


sed 


sync 


true 


ar 


chmod date 


echo 


kill 


mall 


run pwd 


sh 


tar 


wall 


as 


clear dd 


ed 


Id 


mkdlr 


od rm 


size 


tee 


who 


awk 


cmp df 


expr 


In 


mt 


passwd rmall 


stty 


test 


write 


cat 


cp diff 


false 


login tw 


pr rmdir 


su 


time 





Note: The files in the directory /etc vary according to hardware configuration 



./etc: 






ac 


ddate 


fback4 


accton 


dinit 


fback5 


backup 


dlskformat 


fback6 


badblk 


dism 


fback7 


boot 


dump 


fback8 


change 


dumpdir 


fback9 


checklist 


fbackl 


fsck 


chgrp 


fbacklO 


getty 


chown 


fbackl 1 


group 


clri 


fbackl2 


icheck 


cron 


fback2 


ident 


dcheck 


fback3 


init 


•/fsys: 







install 




restor 


installlO 




restore 


installll 


mkboot 


sa 


installl2 


mkf s 


switch 


install2 


mklost+found 


termcap 


install3 


mknod 


test 


install4 


motd 


ttys 


installs 


mount 


ttytype 


installs 


mtab 


umount 


lnstall7 


ncheck 


update 


lnstall8 


passwd 


utmp 


lnsta!19 


rc 





lost+found: 



Mote: The files in the /dev directory vary according to hardware configuration 



./dev: 

MAKE null rwdfOh rwdwOd rwdwOh tty2 

console pip rwdwOa rwdwOe swap tty3 

kmem rwdfOa rwdwOb rwdwOf tty tty4 

mem rwdfOc rwdwOe rwdwOg ttyl tty 5 



wdfOa wdwOb wdwOf 

wdfOc wdwOc wdwOg 

wdfOh wdwOd wdwOh 

wdwOa wdwOe 



•/ flop: 



./lib: 

c2 cpp f77passl libera libm.a mcrtO.o yaccpar 

ccom crtO.o f77pass2 libl.a makekey nlibc.a 

•/tmp: 



•/usr: 

adm diet Include lost+found spool tmp 

bin guest lib sre 



•/usr/ adm: 

acct housekeeping wtmp 



UNIX Filelist (continued) 



^/ usr/ diet: 

ilista hllstb hstop 

•/ us r/ include: 
O.stdio.h ctype.h 



spellhist words 



ident.h 
lastlog.h 
math.h 



SIII curses «h 

a • out • h dump res t o • h 

ar.h dump res tor. h misc 

assert. h errno.h nllst.h 

core.h grp.h pagsiz.h 



pkh.h 

pkp.h 

pwd.h 

ranlib.h 

set jmp.h 

sgtty.h 



signal. h 
stdio«h 
stdio.new 
sys 

sysexits.h 
time#h 



utmp.h 
varargs.h 
whoami . h 



• / us r/ los t+f ound : 
•/usr/ spool: 

at lpd mail 

•/ usr/ tmp: 
•/usr/ bin: 



adb 


crypt 


explain 


look 


admin 


ctags 


f77 


lorder 


at 


cu 


fgrep 


lpq 


basename 


dc 


file 


lpr 


be 


delta 


find 


lprm 


bdiff 


deroff 


fmt 


m4 


cal 


diction 


fold 


make 


^lendar 


diff3 


f req 


man 




diffdir 


get 


mesg 


ede 


edit 


head 


mkstr 


chsh 


egrep 


help 


more 


col 


eqn 


join 


neqn 


colrm 


error 


last 


newgrp 


comb 


ex 


lex 


nrof f 


comm 


expand 


lint 


num 



•/usr/ guest: 

•cshre • login • profile 



uucppubllc 



p 


secsdlf f 


tail 


uuname 


page 


script 


tbl 


uux 


pc 


see 


tee 


val 


print 


sleep 


touch 


vc 


printenv 


sort 


tr 


vi 


prof 


spell 


troff 


we 


prs 


spellln 


tset 


what 


ptx 


spellout 


tsort 


whereis 


ranlib 


split 


tty 


whoami 


reset 


ssp 


ul 


xstr 


rev 


strings 


unget 


yacc 


rewind 


strip 


uniq 


yes 


rmchg 


style 


units 




rmdel 


sum 


uucp 




sact 


swart 


uulog 





./usr/ lib: 










Mail. help 


dprog 


lib300.a 


llbmath.a 


spell 


Mail.help.~ 


eign 


lib300s.a 


libtermcap.a 


stylel 


Mail.rc 


ex3.6preserve llb4014.a 


llbtermlib.a 


style2 


aliases 


ex3.6recover 


lib450.a 


lint 


style3 


at run 


ex3.6string8 


libP77.a 


lintl 


tabset 


calendar 


explain. d 


libI77.a 


lint2 


term 


crontab 


help 


libPW.a 


lpd 


tmac 


deroff 


lex 


llbcurses.a 


Ipf 


unit tab 


dict.d 


lib.b 


libl.a 


me 


uucp 



UNIX Filelist (continued) 



♦/usr/src: 
unix 



./usr/ include/ SIII : 
fatal. h macros *h misc.h 

•/ usr/ include/ raise: 
upara.h 



•/usr/ include/ sys : 



acct«h 

altblk.h 

boot«h 

buf.h 

callo.h 

cdp.h 

confab 



dei.h 
dir.h 

diskfomwh 
disktune.h 
fblk.h 
file.h 
f ilsys.h 



• /usr/ spool/ at: 
lasttimedone past 

•/usr/ spool/ lpd: 
tfa!5181 



imi.h 

ino.b 

inode.h 

ioctl.b 

ipe.b 

kprof .h 

map.b 



mmu« h 
mount .h 
mtio.h 
rax.b 

newconf «b 

nproc.h 

paranwh 



pci.h 

pibdef s.h 

pk»h 

pk.p 

proc.h 

pwd«b 

px.h 



reg.h 

smd.h 

stat.h 

systnuh 

text.h 

timeb«b 

times .h 



tty.h 
types «h 
user.h 
wdc.h 
wdf .h 
wdw«h 



•/usr/ spool/ mail : 

•/ usr/ spool/ uucp : 

'usr/ spool/ uueppublic: 

./usr/ lib/ lint: 
llib-lc llib-lc*ln 



•/usr/ lib/ tabset : 

3101 beehive std teleray xerox 1720 

aa diablo stdcrt vtlOO 

•/usr/ lib/ term: 

tab300 tab300s tab450-12 tab5520 tabxl700 

tab300S tab37 tab450-12-8 tab5520-12 

tab300X tab450 tab450X tabtn300 

•/usr/ lib/ help: 

ad cb cmds de ge prs un vc 

bd cm co default he rc ut 



•/usr/ lib/ tmac: 

tmac.a tmac«an«new tmac.e 

tmac«an tmac.an6n tmac.m 
tmac*an.V7 tmac.an6t tmac.s 



tmac.scover tmac.srefs 
tmac • sdisp tmac • vcat 
traac.skeep 



UNIX Filelist (continued) 



./usr/ lib/ lex: 
ncform 

^ usr/ lib/ me: 

Rim. me eqn.me Index, me 

chars .me float .me local. me 
del text. me foot note. me null • me 



revisions 

sh.me 

src 



tbl.rae 
thesis « 



•/usr/ lib/ uucp : 

•XQTDIR L-dialcodes SEQF UUCPLNAME uuclean 

L-devices L.sys USERF1LE uuclco uuxqt 

•/usr/src/unix: 
lib sys 



•/usr/ spool/ at/ past: 
./usr/ lib/ me/ src: 

acm.me eqn.me index. me local. me 

chars.me float.me Install null. me 



deltext.me footnote. me install. csh revisions 

./usr/ lib/ uucp/ .XQTDIR: 

./ usr/ src/ unlx/ lib: 
libunlx.a 



sh.me test .umlaut 

tbl.me thesis .me 

test .accent tmac.e 



•/ usr/ src/ unix/ sys : 

ifctkefile c.c unlxlOO.a unixlSO.a 



** 3*0 INSTALLATION/ BACKUP INSTRUCTIONS 



3.1 TAPE MEDIA 

3.1.1 Installation 

Note: Firmware changes and hardware modifications are necessary when 
the UNIX operating system is loaded on SMD devices that 
currently have MCS. If you wish to do so, contact WICAT 
Customer Service for assistance* 

The UNIX operating system is factory installed on your WICAT system. 
Therefore, you will only need to use this installation procedure in the 
unlikely event that your system disk becomes unreadable. The 
installation procedure steps you through the load of your system backup 
tape. 

3.1.1.1 SMD Disk / Cipher Tape 

a. Insert the tape into the tape drive. 

b. Press the reset button. 

c. When the following message: 

Booting... 

appears, depress the space bar several times. 

d. The system will display: 

Boot failed. Enter boot id (P/S, drive id) 

e. Type the following: • 

sOaO <return> 

f • The tape boot loader will load the boot monitor. When the boot 
monitor is loaded, it will display the prompt '»'• 

NOTE: The error ' Spurious interrupt at level 4' may appear on the 
screen during installation. Ignore this error. However, 
if any other errors occur, reboot the system and try this 
procedure again. If the error persists, contact WICAT Customer 
Service for assistance. 

NOTE: The boot monitor will only recognize the following commands: 

format mkfs Icheck 

restor Is 

cat boot 
These commands are created specifically to work with the boot 
monitor, and will not work exactly as described in the UNIX 
Users Manual when they are run from the boot monitor. 



NOTE: The boot monitor accepts the backppace key as theddelete key. 
Use backspace to correct any typing errors. ' 

NOTE: Step g (formatting the disk) is optional for disks that have 
already been formatted. 



UNIX Tape Installation Procedure (continued) 
g. Format the Disk by typing: 

format <return> 

The system will search for the format command on the tape* It will 
take approximately 30 seconds for the system to find format and load 
it into memory* When it is loaded, the system will display: 

drive: 

In response to this prompt, type: 

smdO(Oh) <return> 

If format cannot find a boot block, it will print the message: 

no boot block on device 
drive type: 

If this happens, enter the following: 

f 80 <return> (If the disk is a Fujitsu 80 Mb) 
f 160 <return> (If the disk is a Fujitsu 160 Mb) 
f474 <return> (If the disk is a Fujitsu 474 Mb) 

The system will initialize the disk* It takes approximately 15 
minutes to initialize a 80 megabyte disk, 30 minutes to initialize 
a 160 megabyte disk, and 45 minutes to initialize a 474 megabyte 
disk* When this step is completed, it will display 'done' and 
the prompt 

h* Make the 'a' filesystem by typing: 

mkfs <return> 

The system will look for and load the mkfs utility into main memory* 
When mkfs is finished loading, it will print the message: 

fs size: 

In response to this prompt, type: 

6332 <return> 
Mkfs will now display: 

fs: 

la response to this prompt, type: 

smd0(0a) <return> 

It should take approximately 4 minutes to create the filesystem* 
When it is finished, it will print 'done*' and the prompt 



UNIX Tape Installation Procedure (continued) 
i. Type: 

restor <return> 

The system will find and load the restor utility* When it is 
finished loading, restor will display: 

input device: 

In response to this prompt, type: 

cdpO(Oe) <return> 

The system will search the tape for this file. When it has 
found it, it will display: 

output device: 

In response to this prompt, type: 

smdO(Oa) <return> 

This will restore the files on the 'a' filesystem to the disk* It 
will take approximately 45 minutes. When it is finished, it will 
display 'input device: ' again. 

j. Reboot the system from the tape by repeating steps b through f. 

k. When the prompt appears, type: 

boot <return> 

When the boot program is loaded it will display the prompt: 



In response to this prompt, type: 

smdO(Oa) <return> 

This will load /unix from the disk. When it is finished loading, 
the standard UNIX prompt '#' will appear, and you will be running 
off of the disk. 

Note: Use the <delete> key to delete characters from the command 

line when running from /unix. 
1. type: 

cd / dev <return> 



UNIX Tape Installation (continued) 

m. Change permissions on the device MAKE files by typing: 

chmod 755 MAKE <return> 

This will allow you execute the command files which build 
nodes for the particular hardware configuration on your system. 
It should take only a few seconds for this to execute. When 
it is finished, the prompt should appear* 
n* Make the proper filesystems by typing: 

MAKE 200 <diskjtype> ctO ipeO std <return> 

Where diskjiype is: 

sparrowO if the disk is a Fujitsu 80 Mb 

hawkO if the disk is a Fujitsu 160 Mb 

eagleO if the disk is a Fujitsu 474 Mb 



o* Type the following: 

mkboot /dev/rsmdOh <drive_type> /etc/ boot <return> 

Where drive_type is: 

f 80 if the disk is a Fujitsu 80 Mb 

f 160 if the disk is a Fujitsu 160 Mb 

f 474 if the disk is a Fujitsu 474 Mb 

This will build a boot program for the disk* It should take 
approximately 4 seconds to run. When it Is finished f the 
prompt will appear* 
p* type: 

sync <return> 

This will flush the disk buffers* It should only take a few seconds 
to run* When it is finished the prompt '#' will appear* 
q* Type: 

fsck /dev/smdOa <return> 

Fsck checks the consistancy of the file system* If It finds any 
mistakes , it will prompt for permission to correct the errors* At 
this time there may be several mistakes that need correcting* Answer 
yes to all requests* It will take approximately 3 minutes to run 
fsck. When it is finished, the prompt '#' will appear* 
r* If fsck did not make any corrections t type: 

sync <return> 

and continue with step q* 

NOTE: Fsck may prompt you to reboot the system even if no changes were 
made. This is due to a bug in fsck. DO NOT reboot the system 
unless changes were made to the f ilesystem by fsck. 



UNIX Tape Installation (continued) 

a. If fsck made corrections to the f ilesystem, reboot the system 
Immediately by pressing the reset switch* This time the system 
will boot from the disk Instead of the tape* Do not press the 
space bar while it is booting this time* When the system displays 
the prompt: 



type: 

<return> 

and the system will finish booting* When the system is finished 
booting, it will display the prompt '#'• 

t* Make the 'g' filesystem by typing: 

/etc/mkfs /dev/smdOg <size> <return> 

where: 

size is: 



109504 If the disk is a Fujitsu 80 Mb 

240928 if the disk is a Fujitsu 160 Mb 

718528 if the disk is a Fujitsu 474 Mb 

It should take approximately 4 minutes for mkfs to run* When it is 
finished, the prompt '#' will appear* 
u* Rewind the tape by typing: 

mt rew <return> 

It may take approximately 20 seconds for the tape to rewind 
completely. When it Is finished, the prompt '#' will appear* 
v* The /usr filesystem is located in the sixth file on the tape. Skip 
the first five files by typing: 

mt fsf 5 <return> 

It should take approximately 5 minutes for the tape to skip to the 
correct file* When it is finished, the prompt '#' will appear* 
w. Restore the /usr filesystem by typing: 

res tor rf /dev/rct4 /dev/smdOg <return> 



It will take approximately 1 hour for /usr to be restored from the 
tape* When it is finished* the prompt '#' will appear* 



UNIX Tape Installation (Continued) 

x* Run fsck on the /usr fllesystem by typing: 

fsck /dev/smdOg <return> 

Answer, yes to any corrections fsck may have to make. It will take 
approximately 8 minutes to run fsck* When It Is finished, the prompt 
will appear. 

y. The system is now built. Type: 

<ctrl>d 

After daemons are started 9 the login message should appear, 
log In as 



root <return> 

to be the superuser. Directions for adding users are found in 
passwd(5) of the UNIX User's Manual. 



3.1.1.2 Winchester Disk / DEI Tape 

a* Insert the tape Into the tape drive. 

b. Press the reset button. 

c. When the following message: 

Booting.. • 

appears , depress the space bar several times. 

d. The system will display: 

Boot failed. Enter boot id (P/S, drive id) 

e. Type the following: 

sObO <return> 

f • The tape boot loader will load the boot monitor. When the boot 
monitor is loaded, it will display the prompt 

NOTE: The error 'Spurious interrupt at level 4' may appear on the 
screen during installation. Ignore this error. However, 
if any other errors occur, reboot the system and try this 
procedure again. If the error persists, contact WICAT Customer 
Service for assistance. 

NOTE: The boot monitor will only recognize the following commands: 

format mkfs lcheck 

restor Is 

cat boot 
These commands are created specifically to work with the boot 
monitor, and will not work exactly as described in the UNIX 
Users Manual when they are run from the boot monitor. 

NOTE: The boot monitor accepts the backspace key as the delete key. 
Use backspace to correct any typing errors. 

NOTE: Step g (formatting the disk) is optional for disks that have 
already been formatted. 



UNIX Tape Installation Procedure (continued) 
g* Format the Disk by typing: 

format <return> 

The system will search for the format command on the tape* It will 
take approximately 30 seconds for the system to find format and load 
It Into memory* When It is loaded, the system will display: 

drive: 

In response to this prompt 9 type: 

wdwO(Oh) <return> 

If format cannot find a boot block, it will print the message: 

no boot block on device 
drive type: 

If this happens, enter the following: 

cmllO if the disk is a 10 megabyte 

cmil5 If the disk is a 15 megabyte 

The system will Initialize the disk* When this step is completed, 
It will display 'done' and the prompt '«'• 

h* Make the 'a' filesystem by typing: 

mkfs <return> 

The system will look for and load the mkfs utility into main memory* 
When mkfs is finished loading, it will print the message: 

fs size: 

In response to this prompt, type: 

5950 <return> 
Mkfs will now display: 

fs: 

In response to this prompt, type: 

wdwO(Oa) <return> 

It should take approximately 4 minutes to create the filesystem* 
When It is finished, it will print 'done*' and the prompt '*'• 



UNIX Tape Installation Procedure (continued) 
1. Type: 

restor <return> 

The system will find and load the restor utility. When it is 
finished loading, restor will display: 

input device: 

In response to this prompt, type: 

deiO(Od) <return> 

The system will search the tape for this file. When it has 
found it, it will display: 

output device: 

In response to this prompt, type: 

wdwO(Oa) <retum> 

This will restore the files on the 'a' filesystem to the disk. It 
will take approximately 45 minutes. When it is finished, it will 
display 'input device:' again. 

j. Reboot the system from the tape by repeating steps b through f. 

k. When the prompt appears, type: 

boot <return> 

When the boot program is loaded it will display the prompt: 



In response to this prompt, type: 

wdcO(Oa) <return> 

This will load /unlx from the disk. When it is finished loading, 
the standard UNIX prompt '#' will appear, and you will be running 
off of the disk. 

Note: Use the <delete> key to delete characters from the command 

line when running from /unix. 
1. type: 



cd /dev <return> 



UNIX Tape Installation (continued) 

m* Change permissions on the device MAKE files by typing: 

chmod 755 MAKE <return> 

This will allow you execute the command files which build 
nodes for the particular hardware configuration on your system. 
It should take only a few seconds for this to execute* When 
it is finished, the prompt ' should appear, 
n* Make the proper filesystems by typing: 

MAKE 200 <diskjtype> ctO ipeO std <return> 

Where diskjtype is: 

wdwlO.O if the disk is a 10 megabyte 

wdwl5*0 if the disk is a 15 megabyte 

o. Type the following: 

mkboot /dev/rwdwOh <drive_type> /etc/ boot <return> 

Where drivejtype is: 

cmilO if the disk is a 10 megabyte 

cmll5 if the disk is a 15 megabyte 

This will build a boot program for the disk. It should take 
approximately 4 seconds to run* When it is finished, the 
prompt '#' will appear* 
p* type: 

sync <return> 

This will flush the disk buffers* It should only take a few seconds 
to run* When it is finished the prompt '#' will appear* 
q. Type: 

fsck /dev/wdwOa <return> 

Psck checks the consistancy of the file system* If it finds any 
mistakes, it will prompt for permission to correct the errors. At 
this time there may be several mistakes that need correcting. Answer 
yes to all requests* It will take approximately 3 minutes to run 
fsck* When it is finished, the prompt '#' will appear* 
r. If fsck did not make any corrections, type: 

sync <return> 

and continue with step q* 

NOTE: Fsck may prompt you to reboot the system even if no changes were 
made* This is due to a bug In fsck* DO NOT reboot the system 
unless changes were made to the filesystem by fsck* 



UNIX Tape Installation (continued) 

3* If fsck made corrections to the filesystem, reboot the system 
Immediately by pressing the reset switch* This time the system 
will boot from the disk instead of the tape* Do not press the 
space bar while it is booting this time* When the system displays 
the prompt; 



type: 

<return> 

and the system will finish booting* When the system is finished 
booting, it will display the prompt 

t* Make the 'g' filesystem by typing: 

/etc/mkfs /dev/wdwOg <size> <return> 

where: 

size is: 

10678 if the disk is a 10 megabyte 

21082 if the disk is a 15 megabyte 

It should take approximately 4 minutes for mkfs to run* When It is 
finished, the prompt will appear* 
u. Remove the boot tape and insert the user tape* 
v* Restore the /usr filesystem by typing: 

restor rf /dev/rct4 /dev/wdwOg <return> 

It will take approximately 1 hour for /usr to be restored from the 
tape. When it is finished, the prompt will appear* 



UNIX Tape Installation (Continued) 

w. Run fack on the /usr fllesystem by typing: 

fsck /dev/wdwOg <return> 

Answer yes to any corrections fsck may have to make* It will take 
approximately 8 minutes to run fsck. When it is finished, the prompt 
'#' wili appear. 

The system is now built. Type: 

<ctrl>d 

After daemons are started, the login message should appear, 
log in as 



root <return> 

to be the superuser. Directions for adding users are found in 
passwd(5)oof the UNIX User's Manual. 



3.1.2 Backup 



The following procedure will step you through backing up UNIX 

to tape. It will create a bootable tape similar to the tape 

shipped with the system, but will also include any user files that are 

on the disk* Since the operating system takes 700 to 900 feet of tape, 

a 1200 foot or larger tape should be used. User files will require 

additional 4 space* If the user files take up enough space, an 

additional tape may be necessary* 

a* Become the superuser by using the su(l) command or logging in as 
'root'. 

b. This will log you in as the super-user. 

c. Make sure the write-enable ring is on the tape and load the tape 
into the drive. 

d. Type: 

cd /etc <return> 

to change to the /etc directory. 

e. Type: 

MKDT <return> for cipher tapes 

MKCT <return> for DEI tapes 



3.1.2 Backup 

The following procedure will step you through backing up UNIX 

to tape. It will create a bootable tape similar to the tape 

shipped with the system, but will also Include any user files that are 

on the disk. Since the operating system takes 700 to 900 feet of tape, 

a 1200 foot or larger tape should be used. User files will require 

additional space. If the user files take up enough space, an 

additional tape may be necessary. 

a. Become the superuser by using the su(l) command or logging in as 
'root'. 

b. This will log you in as the super-user. 

c. Make sure the wrlte-enable ring is on the tape and load the tape 
into the drive. 

d. Type: 

cd / etc <return> 

to change to the /etc directory. 

e. Type: 

MKDT <returti> for cipher tapes 

MKCT <return> for DEI tapes 

This will back up the the system to tape. It takes approximately 
12 minutes to back up a system that has no user files. 

f . When MKDT is finished executing, the UNIX prompt '#' should appear. 
UNIX backup is complete. Unload the tape. 



Diskette load procedure (continued) 

!• Press the reset button. The system will now boot from the Winchester 
disk. When the prompt f, # H appears, type: 



# /etc/ Install <return> 

The system will prompt you for the diskette number to install. When 
this happens type: 

all <return> 

and diskettes 2 through 13 will be loaded. When prompted to insert 
another diskette, insert the diskette and type '^returnX*. It should 
take approximately 55 minutes to load these 11 diskettes. 

3.2.2 Backup 

Backing up UNIX will take 12 diskettes. The following will step you 
through the backup procedure. 

a. Become the superuser by using the su(l) command, or logging 
in as 'root'. 

b. type: 

/etc/ backup <return> 

to execute the backup command file. 

c. The system will ask which diskettes should be backed up. If you want 
to back up the whole operating system type "all <cr>". When 
prompted, insert a new diskette and type "<cr> M . 

4.0 NEW FEATURES 

4.1 NEW HARDWARE 

UNIX now works on the System 200, and device drivers are now written 
for cypher and DEI tape drives. The utilities tar, dump, 
restor, and dd will copy data to and from tape. There is a standalone 
boot program that works from the tape. 

4.1.1 Writing and reading tape 

tar - Tar works as documented in the users reference manual. 

However, the f option and the file /dev/mt4 or /dev/mtO 
must be used in reference to the tape. Tar will not default 
to the tape. It defaults to 512 byte blocks. 

dump - Backup will work as documented In dump(8) of the users 
reference manual. Again, the destination device is 
/dev/mt4 or /dev/mtO. Use the raw device for block sizes 
greater than 512 bytes. 

restor - Restor will work in the same manner as backup. Before 

restoring, the tape head must be advanced to the beginning 
of the restor container file. Mt may be used for this 
(see section 4.1.3 in this release notice). 



4.3.2 Boot tape 



The boot tape is divided into a number of physical files. Tapes contain 
2 types of records: data blocks and file marks, with 2 consecutive 
file marks at the end of the logical tape. The following files are 
necessary to the boot and load procedure: 



file 


blocksize 


description 


a 


1024 


An any OS boot block 


b 


1024 


A pc relative a.out loader (Cipher only) 


c 


1024 


The standalone boot monitor 


d 


512 


A tar image of standalone utilities 


e 


512 


A dump of / 


f 


512 


A dump of /usr 



The any OS boot block is a lk area at the beginning of the tape that 
contains information the boot ROMs use. 

The boot loader is a small (under 4k) relocatable executable file that 
loads the boot monitor. There are several constraints that the boot 
ROMs put on this file, including size, sectoring, and format. 

The boot monitor allows users to load and execute several standalone 
utilities which are in tar format and located right after the monitor 
on the tape. 

The stand alone utility programs for the boot monitor are loaded into 
physical address space above the boot monitor and unix. (The boot 
monitor and UNIX live in the same space but never at the same time.) 
The ordinary utilities don't need a start up routine because their 
_main routines are called as ordinary subroutines from the boot 
monitor. (And they inherit the boot monitors stack) The utilities are 
expected to return to the boot monitor just like any other subroutine. 
The standalone utilities are: 



format - for formatting disks 

mkfs - creates filesystems 

restor - restors filesystems from tape container files 

boot - boots UNIX from disk (boot never returns to 

the boot monitor) 

Is - lists contents of a directory on a filesystemm 

cat - displays contents of ascii files 



4.3.3 MT utilities 

Mt will perform several functions on a tape, including: 

mt rew <return> 
to rewind the tape; 

mt fsf <file_number> <return> 
to skip filejoumber files. 



4.2 BAD BLOCK HANDLING 

There is a utility called badblk which does bad block handling in 2*0 
UNIX. 

The syntax is: 

badblk <raw_devicejname> [<physical_sectorjmmber>] 

where <raw_device_name> is raw h filesystem for the disk* 
Badblk works in 2 ways: 

1. If the name of a raw device is specified, badblk will read 
every sector on the device and will map good sectors located 
in a bad block pool to any bad sectors that it finds • 

2. If the name of a physical sector on the raw device is 
specified, the sector will be marked bad and and a good 
sector will be mapped to it. Physical sector numbers, along 
with the block numbers, are listed when a read or write 
error occurs* Block numbers are the offset into the logical 
disk and can be used to find the file that occupies the 
sector by typing: 

icheck -b blockjnumber(s) raw_disk_name <return> 

This file should then be recopied from backup. 

After running badblk, dismount the filesystem and run fsck. 

4.2.0 PCI DRIVER 

The pel driver has been rewritten to work In tandem mode and 

at 134.5 baud. The problem with losing characters has been diminished 

considerably. 

4.3.0 NEW/ ENHANCED UTILITIES 



The 


following utilities 


have been added 


since the last 


release: 




spell 


diction 


ac 


uux 




tbl 


style 


calendar 


mt 




neqn 


explain 


fold 






be 


expand 


lorder 






chsh 


fmt 


m4 






colrm 


Ipr 


man 






script 


lint 


sa 






sees 


uuep 


tsort 




The 


following utilities 


have been fixed 


since the last 


release: 




csh 


at 


fsek 






awk 


crypt 


dd 






adb 


cu 


pa 




The 


following libraries 


have been added 


since the last 


release: 



lib.b 



libcurses 



libl 



5.0 



NOTES/ WARNINGS 



3.1 ADDING USERS 

1. Become the superuser by logging in as 'root' or using su(l). 

2. Edit the file /etc/passwd using the field definitions given in 
passwd(5) in the UNIX Users Manual. 

3. Create the user directory using mkdir. The user directory should 
be a subdirectory of /usr. A description of mkdir is found in 
mkdir(l) of the UNIX Users Manual. 

4. Change the owner and group of the directory to the username by 
using the chown and chgrp commands. 

5. A login shell file may be created. It must be in the users 
directory and be named .login if the user is using /bin/csh 
for the shell and .profile if the user is using /bin/sh for the 
shell* There are copies of .login and .profile in / and these 
can be copied to the user directory if desired. 

6. Change the owner of the login file using the chown command. 



5.2 FILESYSTEMS 



Following Is a brief description of the 8 logical filesystems 
on a UNIX disk: 



a - root file system, 
b - swap area* 

c - entire disk minus boot, forwarded bad blocks 
d - combination of a + b. 

e - possible alternative to user filesystem. The first 
30000 bytes of the user filesystem. (only on smd's) 

f - possible alternative to user filesystem. The user 
filesystem minus filesystem e. 

g - default user filesystem. Size of e + f • 

h - entire physical disk 



Note: You cannot have filesystem g on the same disk that has 
filesystems e and f f since g overlaps e and f. 

Note: The address and the size of the filesystems cannot be changed 
at this time. This means that users creating filesystems on 
other disks must use the same sizes as already set up 
on the system disk. 



5.3 STARTUP AND SHUTDOWN 



5.3.1 Startup 



Note: Refer to boot (8) in the Users Reference Manual for a more 
complete description. 



Following is the correct procedure to power up the system, 
a. Turn the power on. The mesage: 



Booting.. 
Memory test 



should appear almost immediately 



System Initialization (continued) 

b. The system will do some hardware tests and read the boot 
program from the disk. The boot program resides in sectors 
1 to 64 on the primary disk (the any OS boot block is in sector 
0)* When the boot program is loaded, it displays the message: 

System loader loaded* 
Standalone boot 



Pressing return at this time will cause the system to continue 
booting normally by loading /unlx as the operating system 
kernel. Another file may be specified as the system kernel* This 
would be useful for debugging versions on /unlx with new or altered 
device drivers* The kernel file should be in the root (/ ) directory* 

c* The system will display the loading address, the text size and the 
initialized and uninitialized data sizes of the unlx kernel. 

d. The UNIX kernel will now begin executing, first figuring 

and displaying the available amount of memory, then initializing the 
scheduler (process 0) and starting inlt (process 1), which starts 
the superuser shell. 

e* In response to the superuser shell prompt, '#', run fsck to check 
the consistancy of the filesystem* If fsck made any corrections 
to the filesystem, reboot immediately* Fsck will only change the 
root filesystem on the disk, not in any buffers, and if the buffers 
get flushed to the disk, the inconsistencies would appear again* If 
no corrections were made, rebooting is unnecessary*, 

f* Set the date at this time* If the date is set when the system is 
in multiuser mode, the cron program may behave abnormally* 

g* Type <ctrl> d* This will execute the shell file /etc/rc* In the 
standard release version, /etc/rc mounts the user file system and 
starts cron* Also at this time, lnlt will spawn getty, the login 
process, for each login port on the system* 

h* The system will display: 

login: 

at each valid login port* Users may now log in and work normally* 
5. 3. 2 Shutdown 

The following procedure should be used by the superuser in shutting 
down the machine* 

a* Kill all of the processes but the single-user shell by typing: 

kill 1 <return> 

b* Dismount all mount filesys terns, 
c* Type: 

sync <return> 

This will flush all of the disk buffers, 
d. When all disk activity has stopped, power off the machine. 



Note: This procedure should be done from the system console after 
warning all users. 



5.4 USING DISKETTES 



On the system 150, the standard backup media is 5 1/4 inch diskette* 
There are several methods in UNIX for accessing diskettes. 

5.4.1 Creating Filesystems 

This method will allow a floppy to be written to and read as if it 
were another directory. To use this method, do the following: 

1. Type: 

<ctrl>d 

and login as the superuser by typing: 
root <return> 

When the prompt appears, you are logged in. 

2. Insert the floppy into the floppy drive. Make sure it is not 
write-protected, 

3. Type: 

diskformat /dev/rwdfOh <return> 

This will format the diskette. It should take approximately 
2 minutes to execute. When it is finished, the prompt '#' 
should return. 

4. A filesystem must be made on the diskette. To to this, type: 

mkfs /dev/wdfOa 1116 1 16 <return> 

It should take approximately 30 seconds to run mkfs. When it 
is finished executing, the prompt '#' should appear. 

5. Mount the filesystem by typing: 

mount /dev/wdfOa /flop 

The root of the floppy will now be the directory /flop Directories 
can be created and deleted and files can be read, copied to and from, 
deleted, and executed on the floppy just by using / flop. Dismount the 
floppy by typing: 

cd / <return> 

umount /dev/wdfOa <return> 

Accessing a diskette that has already been created can be done by 
repeating step 1 to log in as the superuser and step 5 to mount the 
floppy. 



5.4.2 Tar 



Tar is a quick and easy method for backing up specific files and 
directories to the floppy. To use tar, do the following: 
lm Insert the floppy into the floppy drive. Make sure it is not 
write-protected. 

2. Type: 

diskformat /dev/rwdfOh <return> 

This will format the diskette. It should take approximately 
2 minutes to execute. When it is finished, the prompt '#' 
should return. 

3. Type: 

tar cvf /dev/wdfOc <filelist> <return> 

Where filelist is the list of files to be backed up. Wildcards 
may be used. 
To recopy tar files to the disk, type: 

tar xvf /dev/wdfOc <return> 

5.4.3 Dump and Restor 

Dump will back up all of the files on a filesystem that have not 
already been backed up. It is very slow and will take up several 
diskettes, especially when it Is 'run for the first time. However, 
it is very thorough and fairly easy to use. There are several options 
in dump that are not described here. A more complete description is 
found in dump(l) in the UNIX Users Manual. To use dump, do the 
following: 

1. Type: 

<ctrl>d 

and login as the superuser by typing: 
root <return> 

When the prompt '#' appears, you are logged in. 

2. Insert the floppy into the floppy drive. Make sure it is not 
write-protected. 



Bump and Res tor (continued) 
3. Type: 

format /dev/rwdfOh <return> 

This will format the diskette* It should take approximately 
2 minutes to execute* When it is finished 9 the prompt '#' 
should return* 
4* Type: 

dump fb /dev/wdfOc 1132 <device_name> 

where device__name is the name of the device to be dumped* It 
must be either the 'a' or the 'g' device on the Winchester disk. 
This will dump the contents of the filesystem to diskette* It 
will prompt you from time to time to insert diskettes* When this 
happens, insert a formatted floppy and press <return>. 

If it necessary to use restor, use the directions given in restor(l) 

of the user's manual. 



CHANGING TIMEZONES 



WICAT UNIX systems sent from the factory are set for the Mountain 
Time Zone. To reconfigure the system for other timezones, do the 
following: 

1* Boot the system normally and login as 'root'. 

2. Type the following: 

adb -w /unix <return> 

3. The system will return with the message: 

a .out file - /unix 
core not found 
ready 

When this message appears , type the following: 

tlmezone?W Od<minutes> <return> 

Where minutes is: 

300 for Eastern time 
360 for Central time 
420 for Mountain time 
480 for Pacific time 

Note: 'timezone' determines the time zone for the system by giving 
• the minutes west of Greenwich Mean Time. It is set at the 
factory to the value 420. 

Note: Make sure that 'timezone' is in lower case* Make sure there 

are no spaces between 'timezone' and '?', and no spaces between 
'?' and 'W'* 'W' must be upper case* Made sure there is a 
space between the 'W' and the '0' f and no spaces between '0' 
and 'd' and the 'd' and the minutes value* 

4. Type: 

<ctrl>d 

to exit adb* 

5* Shut down the system and reboot* When the system comes it should 
be in the new time zone* 

Note: Patching the kernel is dangerous to the system's lntegerity* 
Be extremely careful in doing so* 



5.6 MFR UTILITY 

mfr is a utility provided on the system 150 and 160 which allows 
UNIX systems to read MCS 5 1/4 diskettes. It will read MCS version 
2.3 or later formats. To use mfr, do the following: 

a. Log in as 'root', then insert the MCS diskette into the drive. 

b. Type the following: 

mfr /dev/wdfOh <return> 
mfr will respond with the mfr prompt: 
next? 

c. The following commands work with mfr: 



<directory>/ <subdir.> <return> lists the contents of a subdirectory 
<directory>/ <f llename> <return> causes mfr to display: 



<return> 



lists the contents of ROOTDIR.DIR. 



<directory> <return> 



lists the contents of a main directory. 



output file? 



Type in the name of the destination file 
and press <return>. The file will be 
copied from the MCS diskette to the 
UNIX disk. 



Note: On the MCS diskette, upper and lower case letters are 

mapped to upper case. However, there is no mapping in UNIX. 



<ctrl>d 



will exit mfr. 



Note: There Is no entry for mfr in the UNIX documentation. If you 
have any questions on its use, contact WICAT Customer Service 
for assistance. 



5.7 DEVICE NAMES 



The disk device driver names have been changed to a more standard format. 
|The following is the current device name format: 

t <r>] <diskj:ype><dri ve_number><logical_f ile_sys tem> 

where r (optional) is the raw device. 

where diskjtype is: 

wdw for Winchester disks 
wdf for 5 1/4 inch floppies 
smd for smd disks 

where drive_number is an integer in the range 0-3 denoting 
which physical disk drive is to be selected. 

where logicaljE ile_system is a letter in the range 'a' - # h' 
denoting which logical f ilesystem on the disk is to be 
selected. 

Examples : 

wdwOa the 'a' f ilesystem on Winchester drive #0; 

smdOh the entire smd disk 

rwdfOa the raw 'a' f ilesystem on the floppy. 

The device names do not take disk size into account. The minor device 

I umber is what the system uses to determine device size. MAKE will create 
evice nodes tailored for your system. A complete description of MAKE is 
found in MAKE(8) in the UNIX Users Manual. 



FILE : DCOAO/ USRS .AL . PORT/ UNX.RLS.2 



p OTHER NOTES/ PROBLEMS 

1. The sees command "val" is not included* As a consequence, the 
command: 

admin -h <filelist> <return> 
does not work correctly. 

2. Graph, plot and -lplot are not available yet* 

3» System III include files were included to compile sees. 
4* Lpr sometimes core dumps if the passwd file is not proper. 

5. UNIX sometimes gets spurious interrupts on level 4 when using 
the tape drive. This is a hardware problem and does not affect 
the data being transferred. 

6. A process will occasionally go to sleep for about 30 seconds due 
to a bug in the scheduler. It does not occur often and does not 
affect anything else. 

7. There is a problem in the tape controller board that causes the 
system to respond incorrectly when writing to a write-protected tape. 

8. 512Kb boards do not work with UNIX on the System 200. At the present 
time, only 1Mb boards will work on the System 200. 

9. There are still several problems with pcis. On the system 200, 
since there are ports that use the IPE (intelligent port expander) 
board, these pel ports should generally not be used. These ports are 
/dev/ttyi, /dev/tty2, and /dev/tty3. 

10. A new version of the user's manual should be delivered with this 
release. It should more closly match the UNIX operating system 
on WICAT hardware. 



11. Because of the design of the pel interrupt handler, the 

integerity of higher-numbered ports is considerably less than 
lower-numbered ports. This problem is amplified on the systems 
which have 12 pel's. If you have such a system, do not use 
ports 6-12 for input, since a significant portion of the data 
read by these ports will be lost. On all systems using pcis, 
Increased efficiency will result from using lower-numbered 
ports as login ports, and higher-numbered ports for printers and 
other output -only devices. This problem does not exist on system 
200's and 160's that use the IPE board, since IPE boards have 
on-board processors and memory. 



3.2 DISKETTE MEDIA 



BIX is factory installed on your WICAT system. Therefore, you will only need 
To use this installation procedure in the unlikely event that your system disk 
becomes unreadable. The installation procedure steps you through the load of 
your system backup diskettes (see section 3.2.2) 



3.2.1 Installation 

a. Make sure disk 1 is not write-protected, then insert it into the 
floppy drive. 

b. Press the reset button (behind the brightness control). 

c. When the following message: 

Booting... 

appears, depress the space bar several times. 
dm The system will display: 

Boot failed. Enter boot id (P/S, drive id) 

e. Type the following: 

sObO <return> 

The system will now boot from the diskette drive rather than the 
Winchester drive. 

f. The system has finished booting when the prompt appears. 

Note: Step g will, destroy all user files. If you do not want to do 
this, skip step g and go on to step h. 

Note: If you are updating from version 1.0 to 2.0, or converting from 
MCS f or loading an uninitialized system, you must do step 
g because of filesystem changes due to bad block mapping in the 
disk driver. Make sure to back up all user files to floppy before 
starting this step. 

g. To initialize the Winchester, type: 

/etc/dinit <return> 

This will format the Winchester and create the necessary filesystems. 
When the dlnit command file is finished, the prompt '#' will appear. 
It should take approximately 2 minutes to run dlnit. 

h. Enter the following: 

# /etc/ restore <return> 

Enough of UNIX to boot from the Winchester will be loaded from 
diskette 1. When the UNIX prompt '#' appears on the screen, 
installation of disk 1 is complete. 



